为 AnZhiyu 主题开启 Algolia 搜索插件

一、前言

AnZhiyu 支持多种搜索方式，Algolia、本地搜索 和 DocSearch，这里我选择的是 Algolia 搜索。

二、准备 Algolia 账号

首先我们进入 Algolia 官网，登陆方式建议选择 GitHub。

注册完后我们会进入这个页面

三个 API 密钥的作用

  • Application ID： 应用程序ID
  • Search API Key： 搜索API密钥
  • Write API Key： 写入API密钥

创建索引

接着点击左上角的 Search，点击 Create index，在里面输入你想取的搜索引擎索引名字（格式为test_NAME）

三、修改 Hexo 配置文件

在 Hexo 根目录下的 _config.yml 配置文件中，添加 Algolia 配置。

1
2
3
4
5
algolia:
  applicationID: 'Application ID'
  apiKey: 'Search API Key'
  adminApiKey: "Write API Key"
  indexName: '之前创建的索引'
参数 说明
ApplicationID Algolia 的应用程序 ID
ApiKey 搜索密钥，即我们创建的 Algolia 的 Search API Key
AdminApiKey 写入密钥，即我们创建的 Algolia 的 Write API Key
IndexName Algolia 应用的索引名称

四、修改主题配置文件

主题配置文件一般在 Hexo 根目录的 themesanzhiyu_config.yml 文件下，利用关键词搜索 Algolia 找到并开启。

1
2
3
4
5
6
7
algolia_search:
  enable: true
  hits:
    per_page: 6
  tags:
     #- Nginx
     #- Hexo

五、初始化 Algolia

在 Hexo 根目录下运行以下命令来更新 Algolia（更新索引这个步骤在更新博客内容之后，都需要执行一遍）

1
hexo cl && hexo algolia && hexo g

测试